| Paket | flash.globalization |
| Klasse | public final class DateTimeFormatter |
| Vererbung | DateTimeFormatter  Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Es gibt zwei Möglichkeiten, ein Datum- und Uhrzeitformat auszuwählen: mithilfe eines vordefinierten Musters oder mithilfe eines benutzerdefinierten Musters. Für die meisten Anwendungen sollten die von den DateTimeStyle-Konstanten vordefinierten Stile (LONG, MEDIUM, NONE, oder SHORT) verwendet werden. Diese Konstanten geben die Standardmuster für das angeforderte Gebietsschema oder die Standardmuster basierend auf den Betriebssystemeinstellungen des Benutzers an.
Der folgende Code erstellt zum Beispiel einen Datumsstring unter Verwendung des kurzen Standarddatumsformat:
var df:DateTimeFormatter = new DateTimeFormatter(LocaleID.DEFAULT, DateTimeStyle.SHORT, DateTimeStyle.NONE);
var currentDate:Date = new Date();
var shortDate:String = df.format(currentDate);
Wenn eine Instanz dieser Klasse erstellt wird und das angeforderte Gebietsschema vom Betriebssystem unterstützt wird, werden die Eigenschaften der Instanz gemäß den Konventionen und Standards des angeforderten Gebietsschemas und der dateStyle- und timeStyle-Parameter eingestellt. Wenn das angeforderte Gebietsschema nicht verfügbar ist, werden die Eigenschaften gemäß einer Ausweichlösung oder dem Standardgebietsschema des Systems (abzurufen mit der actualLocaleIDName-Eigenschaft) eingestellt.
Diese Klasse enthält zusätzliche Methoden, um lokalisierte Strings für Monatsnamen und Wochentagsnamen sowie den ersten Tag der Woche abzurufen, der in einer Kalenderauswahl oder ähnlichen Anwendungen verwendet werden kann.
Aufgrund der Verwendung von Benutzereinstellungen, von Formatierungsmustern, die vom Betriebssystem bereitgestellt werden, und von einem Ersatzgebietsschema, falls das angeforderte Gebietsschema nicht unterstützt wird, sehen die Benutzer möglicherweise unterschiedliche Formatierungsergebnisse, selbst wenn sie dasselbe Gebietsschema verwenden.
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| actualLocaleIDName : String [schreibgeschützt]
Der Name der Gebietsschema-ID, die von diesem DateTimeFormatter-Objekt verwendet wird. | DateTimeFormatter | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| lastOperationStatus : String [schreibgeschützt]
Der Status der vorherigen Operation, die dieses DateTimeFormatter-Objekt ausgeführt hat. | DateTimeFormatter | ||
| requestedLocaleIDName : String [schreibgeschützt]
Der Name der angeforderten Gebietsschema-ID, der an den Konstruktor dieses DateTimeFormatter-Objekts übergeben wurde. | DateTimeFormatter | ||
| Methode | Definiert von | ||
|---|---|---|---|
DateTimeFormatter(requestedLocaleIDName:String, dateStyle:String = "long", timeStyle:String = "long")
Konstruiert ein neues DateTimeFormatter-Objekt, um Datum- und Uhrzeitangaben gemäß den Konventionen des angegebenen Gebietsschemas und den bereitgestellten Formatierungsstilen für Datum und Uhrzeit zu formatieren. | DateTimeFormatter | ||
Formatiert einen Anzeigestring für ein Date-Objekt, das als in der Zeitzone des Benutzers befindlich interpretiert wird (unter Verwendung der lokalen Zeitkomponenten des Date-Objekts wie: date, day, fullYear, hours, minutes, month und seconds). | DateTimeFormatter | ||
Formatiert einen Anzeigestring für ein Date-Objekt, das als in der UTC-Zeit ausgedrückt interpretiert wird (unter Verwendung der UTC-Komponenten des Date-Objekts wie: dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC und secondsUTC), entsprechend des dateStyle-, timeStyle- oder date-Zeitmusters. | DateTimeFormatter | ||
[statisch]
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden. | DateTimeFormatter | ||
Ruft den Datumsstil für diese DateTimeFormatter-Instanz ab. | DateTimeFormatter | ||
Gibt den Musterstring zurück, der von diesem DateTimeFormatter-Objekt für die Formatierung von Datums- und Uhrzeitangaben verwendet wird. | DateTimeFormatter | ||
Gibt eine Ganzzahl zurück, die dem ersten Tag der Woche für dieses Gebietsschema und dieses Kalendersystem entspricht. | DateTimeFormatter | ||
Ruft eine Liste lokalisierter Strings mit den Monatsnamen für das aktuelle Kalendersystem ab. | DateTimeFormatter | ||
Ruft den Uhrzeitstil für diese DateTimeFormatter-Instanz ab. | DateTimeFormatter | ||
Ruft eine Liste lokalisierter Strings mit den Namen der Wochentage für das aktuelle Kalendersystem ab. | DateTimeFormatter | ||
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
Legt den Musterstring fest, der von diesem DateTimeFormatter-Objekt für die Formatierung von Datums- und Uhrzeitangaben verwendet wird. | DateTimeFormatter | ||
Legt den Stil für Datums- und Uhrzeitangaben für diese DateTimeFormatter-Instanz fest. | DateTimeFormatter | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
actualLocaleIDName | Eigenschaft |
actualLocaleIDName:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Name der Gebietsschema-ID, die von diesem DateTimeFormatter-Objekt verwendet wird.
Es drei Möglichkeiten für den Wert des Namens, abhängig vom Betriebssystem und dem Wert des requestedLocaleIDName-Parameters, der an den Collator()-Konstruktor übergeben wird.
- Wenn das angeforderte Gebietsschema nicht
LocaleID.DEFAULTwar und das Betriebssystem das angeforderten Gebietsschema unterstützt, ist der zurückgegebene Name identisch mit derrequestedLocaleIDName-Eigenschaft. - Wenn
LocaleID.DEFAULTals Wert für denrequestedLocaleIDName-Parameter an den Konstruktor übergeben wurde, wird der Name des aktuellen Gebietsschemas verwendet, der vom Betriebssystem des Benutzers angegeben wird. DerLocaleID.DEFAULT-Wert bewahrt die benutzerdefinierten Einstellungen im Betriebssystem. Mit der Übergabe eines expliziten Werts alsrequestedLocaleIDName-Parameter wird nicht unbedingt dasselbe Ergebnis erzielt wie mit der Verwendung vonLocaleID.DEFAULT, selbst wenn die beiden Gebietsschema-ID-Namen identisch sind. Der Benutzer hat die Gebietsschemaeinstellungen auf seinem Computer möglicherweise angepasst. Wenn Sie einen expliziten Gebietsschema-ID-Namen anfordern, anstattLocaleID.DEFAULTzu verwenden, erhält Ihre Anwendung diese benutzerdefinierten Einstellungen nicht. - Wenn das System den im Konstruktor angegebenen
requestedLocaleIDNamenicht unterstützt, wird ein Ersatzgebietsschema bereitgestellt.
Implementierung
public function get actualLocaleIDName():StringVerwandte API-Elemente
lastOperationStatus | Eigenschaft |
lastOperationStatus:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Status der vorherigen Operation, die dieses DateTimeFormatter-Objekt ausgeführt hat. Die lastOperationStatus-Eigenschaft wird immer festgelegt, wenn der Konstruktor oder eine Methode dieser Klasse aufgerufen oder eine andere Eigenschaft festgelegt wird. Die möglichen Werte sind in der Beschreibung der einzelnen Methoden aufgeführt.
Implementierung
public function get lastOperationStatus():StringVerwandte API-Elemente
requestedLocaleIDName | Eigenschaft |
requestedLocaleIDName:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Der Name der angeforderten Gebietsschema-ID, der an den Konstruktor dieses DateTimeFormatter-Objekts übergeben wurde.
Wenn der Wert LocaleID.DEFAULT verwendet wurde, lautet der zurückgegebene Name "i-default". Das tatsächlich verwendete Gebietsschema kann vom angeforderten Gebietsschema abweichen, wenn ein Ersatzgebietsschema verwendet wird. Der Name des tatsächlich verwendeten Gebietsschemas kann mit der actualLocaleIDName-Eigenschaft abgerufen werden.
Implementierung
public function get requestedLocaleIDName():StringVerwandte API-Elemente
DateTimeFormatter | () | Konstruktor |
public function DateTimeFormatter(requestedLocaleIDName:String, dateStyle:String = "long", timeStyle:String = "long")| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Konstruiert ein neues DateTimeFormatter-Objekt, um Datum- und Uhrzeitangaben gemäß den Konventionen des angegebenen Gebietsschemas und den bereitgestellten Formatierungsstilen für Datum und Uhrzeit zu formatieren. Mit Datums- und Uhrzeitstilen werden Muster für die Formatierung von Datum und Uhrzeit auf vordefinierte, vom Gebietsschema abhängige Muster vom Betriebssystem eingestellt.
Dieser Konstruktor ermittelt, ob das aktuelle Betriebssystem den angeforderten Gebietsschema-ID-Namen unterstützt. Wenn dieser nicht unterstützt wird, wird stattdessen ein Ersatzgebietsschema verwendet. Der Name der Ersatzgebietsschema-ID kann anhand der actualLocaleIDName-Eigenschaft bestimmt werden.
Wenn ein Ersatz für einen der Parameter requestedLocaleIDName, dateStyle oder timeStyle verwendet wird, wird die lastOperationStatus-Eigenschaft festgelegt, um den Ersatztyp anzugeben.
Für die Formatierung anhand der Einstellungen des aktuellen Betriebssystems des Benutzers, übergeben Sie den Wert LocaleID.DEFAULT im requestedLocaleIDName-Parameter an den Konstruktor.
Wenn der Konstruktor aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Wenn der angeforderte Gebietsschema-ID-Name nicht verfügbar ist, hat lastOperationStatus einen der folgenden Werte:
LastOperationStatus.USING_FALLBACK_WARNINGLastOperationStatus.USING_DEFAULT_WARNING
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Details zu den oben aufgeführten Warnungen und zu anderen möglichen Werten der lastOperationStatus-Eigenschaft finden Sie im Abschnitt zur LastOperationStatus-Klasse.
requestedLocaleIDName:String — Der bevorzugte Gebietsschema-ID-Name, der beim Bestimmen von Datums- oder Uhrzeitformaten verwendet wird.
| |
dateStyle:String (default = "long")
| |
timeStyle:String (default = "long")
|
Auslöser
ArgumentError — wenn der dateStyle- oder timeStyle-Parameter keine gültige DateTimeStyle-Konstante ist.
| |
TypeError — wenn der dateStyle- oder timeStyle-Parameter null ist.
|
Verwandte API-Elemente
format | () | Methode |
public function format(dateTime:Date):String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Formatiert einen Anzeigestring für ein Date-Objekt, das als in der Zeitzone des Benutzers befindlich interpretiert wird (unter Verwendung der lokalen Zeitkomponenten des Date-Objekts wie: date, day, fullYear, hours, minutes, month und seconds). Die Formatierung erfolgt unter Verwendung der Konventionen der Gebietsschema-ID und von Datums- und Uhrzeitstil, oder anhand von benutzerdefinierten Datums- und Uhrzeitmustern, die für diese DateTimeFormatter-Instanz angegeben wurden.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Parameter
dateTime:Date — Ein zu formatierender Date-Wert. Der gültige Bereich erstreckt sich vom 1. Januar 1601 bis zum 31. Dezember 30827.
|
String — Ein formatierter String, der den Wert für das Datum oder die Uhrzeit repräsentiert.
|
Verwandte API-Elemente
formatUTC | () | Methode |
public function formatUTC(dateTime:Date):String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Formatiert einen Anzeigestring für ein Date-Objekt, das als in der UTC-Zeit ausgedrückt interpretiert wird (unter Verwendung der UTC-Komponenten des Date-Objekts wie: dateUTC, dayUTC, fullYearUTC, hoursUTC, minutesUTC, monthUTC und secondsUTC), entsprechend des dateStyle-, timeStyle- oder date-Zeitmusters. Die Formatierung erfolgt unter Verwendung der Konventionen der Gebietsschema-ID und von Datums- und Uhrzeitstil, oder anhand von benutzerdefinierten Datums- und Uhrzeitmustern, die für diese DateTimeFormatter-Instanz angegeben wurden.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Parameter
dateTime:Date — Ein zu formatierender Date-Wert. Der gültige Bereich erstreckt sich vom 1. Januar 1601 bis zum 31. Dezember 30827.
|
String — Ein formatierter String, der den Wert für das Datum oder die Uhrzeit repräsentiert.
|
Verwandte API-Elemente
getAvailableLocaleIDNames | () | Methode |
public static function getAvailableLocaleIDNames():Vector.<String>| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden.
Wenn diese Klasse vom aktuellen Betriebssystem nicht unterstützt wird, gibt diese Methode einen Null-Wert zurück.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Vector.<String> — Ein Vektor von Strings, der alle von dieser Klasse unterstützten Gebietsschema-ID-Namen enthält.
|
Verwandte API-Elemente
getDateStyle | () | Methode |
public function getDateStyle():String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Ruft den Datumsstil für diese DateTimeFormatter-Instanz ab. Der Datumsstil wird verwendet, um ein vordefiniertes Muster für die Datumsformatierung vom Betriebssystem abzurufen. Der Wert für den Datumsstil kann vom DateTimeFormatter()-Konstruktor, von der setDateTimeStyles()-Methode oder von der setDateTimePattern()-Methode festgelegt werden.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
String — Der Datumsstilstring für diesen Formatierer.
Mögliche Werte:
|
Verwandte API-Elemente
getDateTimePattern | () | Methode |
public function getDateTimePattern():String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Gibt den Musterstring zurück, der von diesem DateTimeFormatter-Objekt für die Formatierung von Datums- und Uhrzeitangaben verwendet wird.
Dieses kann auf drei Arten festgelegt werden:
- mit den im Konstruktor verwendeten
dateStyle- undtimeStyle-Parametern - mit der
setDateTimeStyles()-Methode - mit der
setDateTimePattern()-Methode
Eine Beschreibung der Syntax finden Sie im Abschnitt zur setDateTimePattern()-Methode.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
String — Ein String mit dem Muster, das von diesem DateTimeFormatter-Objekt für die Formatierung von Datums- und Uhrzeitangaben verwendet wird.
|
Verwandte API-Elemente
getFirstWeekday | () | Methode |
public function getFirstWeekday():int| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Gibt eine Ganzzahl zurück, die dem ersten Tag der Woche für dieses Gebietsschema und dieses Kalendersystem entspricht. Der Wert 0 entspricht Sonntag, 1 Montag usw., 6 entspricht Samstag.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
int — Eine Ganzzahl, die dem ersten Tag der Woche für dieses Gebietsschema und dieses Kalendersystem entspricht.
|
Verwandte API-Elemente
getMonthNames | () | Methode |
public function getMonthNames(nameStyle:String = "full", context:String = "standalone"):Vector.<String>| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Ruft eine Liste lokalisierter Strings mit den Monatsnamen für das aktuelle Kalendersystem ab. Das erste Element in der Liste ist der Name für den ersten Monat des Jahres.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Parameter
nameStyle:String (default = "full")
| |
context:String (default = "standalone")
|
Vector.<String> — Ein Vektor von lokalisierten Strings, der die Monatsnamen für das angegebene Gebietsschema, den Namensstil und den Kontext enthält. Das erste Element im Vektor, bei der Indexposition 0, ist der Name des ersten Monats im Jahr; das nächste Element ist der Name des zweiten Monats im Jahr usw.
|
Auslöser
TypeError — wenn der nameStyle- oder context-Parameter null ist.
|
Verwandte API-Elemente
getTimeStyle | () | Methode |
public function getTimeStyle():String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Ruft den Uhrzeitstil für diese DateTimeFormatter-Instanz ab. Der Uhrzeitstil wird verwendet, um ein vordefiniertes Muster für die Uhrzeitformatierung vom Betriebssystem abzurufen. Der Wert für den Uhrzeitstil kann vom DateTimeFormatter()-Konstruktor, von der setDateTimeStyles()-Methode oder von der setDateTimePattern()-Methode festgelegt werden.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
String — Der Uhrzeitstilstring für diesen Formatierer.
Mögliche Werte:
|
Verwandte API-Elemente
getWeekdayNames | () | Methode |
public function getWeekdayNames(nameStyle:String = "full", context:String = "standalone"):Vector.<String>| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Ruft eine Liste lokalisierter Strings mit den Namen der Wochentage für das aktuelle Kalendersystem ab. Das erste Element in der Liste repräsentiert den Namen für Sonntag.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Parameter
nameStyle:String (default = "full")
| |
context:String (default = "standalone")
|
Vector.<String> — Ein Vektor von lokalisierten Strings, der die Monatsnamen für das angegebene Gebietsschema, den Namensstil und den Kontext enthält. Das erste Element im Vektor, bei der Indexposition 0, ist der Name für Sonntag, das nächste Element ist der Name für Montag usw.
|
Auslöser
TypeError — wenn der nameStyle- oder context-Parameter null ist.
|
Verwandte API-Elemente
setDateTimePattern | () | Methode |
public function setDateTimePattern(pattern:String):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Legt den Musterstring fest, der von diesem DateTimeFormatter-Objekt für die Formatierung von Datums- und Uhrzeitangaben verwendet wird.
Das Muster für die Formatierung von Datumsangaben kann auf drei Arten festgelegt werden:
- mit den im Konstruktor verwendeten
dateStyle- undtimeStyle-Parametern - mit der
setDateTimeStyles()-Methode - mit dieser
setDateTimePattern()-Methode
Als Nebeneffekt dieser Methode werden die aktuellen Uhrzeit- und Datumsstile für dieses DateTimeFormatter-Objekt überschrieben und auf den Wert DateTimeStyle.CUSTOM gesetzt.
Ein Musterstring definiert, wie Datum und Uhrzeit formatiert werden. Das Muster enthält Buchstabenfolgen, die im formatierten String durch Datums- und Uhrzeitwerte ersetzt werden. Im Muster „yyyy/MM“ werden die Buchstaben „yyyy“ durch die vierstellige Jahreszahl ersetzt, danach folgt ein Schrägstrich („/“) und die Buchstaben „MM“ werden durch die zweistelligen Monatsangabe ersetzt.
Viele der in Mustern verwendeten Buchstaben können mehrmals wiederholt werden, um verschiedene Ausgaben zu produzieren, wie nachstehend beschrieben.
Wenn eine Buchstabenfolge die maximal zulässige Anzahl von Buchstaben, die im Muster unterstützt werden, überschreitet, wird sie der längsten unterstützten Folge für diesen Musterbuchstaben zugeordnet. Beispiel:
- MMMMMM wird durch MMMM ersetzt
- dddd wird durch dd ersetzt
- EEEEEEE wird durch EEEE ersetzt
- aa wird durch a ersetzt
- hhh wird durch hh ersetzt
- mmmm wird durch mm ersetzt
Theoretisch kann ein Muster bis zu 255 Zeichen enthalten, bei einigen Plattformen gelten jedoch andere Beschränkungen. Wenn das Muster die zulässige Anzahl von Zeichen überschreitet, wird die lastOperationStatus-Eigenschaft auf den Wert LastOperationStatus.PATTERN_SYNTAX_ERROR gesetzt.
Nicht alle möglichen Muster werden von jedem Betriebssystem unterstützt. Wenn ein Muster von der Plattform nicht unterstützt wird, wird ein Ersatzmuster verwendet und die lastOperationStatus-Eigenschaft gibt an, dass ein Fallback (Ersatz) verwendet wurde. Falls kein angemessenes Ersatzmuster bereitgestellt wird, wird ein leerer String verwendet und die lastOperationStatus-Eigenschaft gibt an, dass das Muster nicht unterstützt wurde.
In der folgenden Tabelle sind die gültigen Musterbuchstaben und ihre Bedeutung aufgeführt.
| Musterbuchstabe | Beschreibung |
| G | Ära. Wird durch den Era-String für das aktuelle Datum und den Kalender ersetzt. Dieses Muster wird nicht von allen Betriebssystemen unterstützt. Bei Betriebssystemen, die die Äraangabe nicht unterstützen, werden die Buchstaben des Eingabemusters durch einen leeren String ersetzt.
Ein Äramuster kann einen bis fünf Buchstaben enthalten, die folgendermaßen interpretiert werden:
Beispiele mit dem Gregorianischen Kalender (für Betriebssysteme, die dieses Muster unterstützen):
|
| y | Jahr. Wenn die Anzahl der Buchstaben im Muster zwei beträgt, werden die letzten beiden Ziffern der Jahreszahl angezeigt; andernfalls bestimmt die Anzahl der Buchstaben die Anzahl der Ziffern. Wenn der Jahreswert mehr Ziffern benötigt als durch die Anzahl der Buchstaben bereitgestellt werden, wird die vollständige Jahresangabe angezeigt. Wenn es mehr Buchstaben gibt als für den Wert erforderlich, werden der Jahreszahl Nullen vorangestellt. In der folgenden Liste sind die Ergebnisse für die Jahre 1 und 2005 angezeigt.
Beispiele:
|
| M | Monat im Jahr. Ein Monatsmuster kann einen bis fünf Buchstaben enthalten, die folgendermaßen interpretiert werden:
Beispiele:
|
| d | Tag des Monats. Das Muster für den Tag des Monats kann einen oder zwei Buchstaben enthalten, die folgendermaßen interpretiert werden:
Beispiele:
|
| E | Tag in der Woche. Das Muster für den Wochentag kann einen bis fünf Buchstaben enthalten, die folgendermaßen interpretiert werden:
Beispiele:
|
| Q | Quartal. Einige Plattformen unterstützen dieses Muster nicht. Ein Quartalsmuster kann einen bis vier Buchstaben enthalten, die folgendermaßen interpretiert werden:
Beispiele (für Betriebssysteme, die dieses Muster unterstützen):
|
| w | Woche des Jahres. Einige Plattformen unterstützen dieses Muster nicht. Dieses Muster kann einen bis zwei Buchstaben enthalten, die folgendermaßen interpretiert werden.
Beispiele für die zweite Woche des Jahres (bei Betriebssystemen, die dieses Muster unterstützen):
|
| W | Woche des Monats. Einige Plattformen unterstützen dieses Muster nicht. Dieses Muster lässt nur einen Buchstaben zu.
Beispiele für die zweite Woche des Monats Juli (bei Betriebssystemen, die dieses Muster unterstützen):
|
| D | Tag des Jahres. Einige Plattformen unterstützen dieses Muster nicht. Dieses Muster kann einen bis drei Buchstaben enthalten.
Beispiele für den zweiten Tag des Jahres (bei Betriebssystemen, die dieses Muster unterstützen):
|
| F | Vorkommen eines Wochentags innerhalb eines Kalendermonats. Dieses Element zeigt zum Beispiel „3“ an, wenn es zur Formatierung des dritten Montags im Oktober verwendet wird. Dieses Muster lässt nur einen Buchstaben zu.
Beispiele für den zweiten Mittwoch im Juli (bei Betriebssystemen, die dieses Muster unterstützen):
|
| a | Angabe für Vormittag/Nachmittag (AM/PM). Dieses Muster lässt nur einen Buchstaben zu , a oder p.
Beispiele:
|
| h | Stunde des Tages im 12-Stunden-Format [1 - 12]. Dieses Muster muss einen oder zwei Buchstaben enthalten.
Beispiele:
|
| H | Stunde des Tages im 24-Stunden-Format [0 - 23]. Dieses Muster muss einen oder zwei Buchstaben enthalten.
Beispiele:
|
| K | Stunde des Tages im 12-Stunden-Format [0 - 11]. Dieses Muster muss einen oder zwei Buchstaben enthalten. Dieses Muster wird nicht von allen Betriebssystemen unterstützt.
Beispiele (für Betriebssysteme, die dieses Muster unterstützen):
|
| k | Stunde des Tages im 24-Stunden-Format [1 - 24]. Dieses Muster muss einen oder zwei Buchstaben enthalten. Dieses Muster wird nicht von allen Betriebssystemen unterstützt.
Beispiele (für Betriebssysteme, die dieses Muster unterstützen):
|
| m | Minute der Stunde [0 - 59]. Dieses Muster muss einen oder zwei Buchstaben enthalten.
Beispiele:
|
| s | Sekunden in der Minute [0 - 59]. Dieses Muster muss einen oder zwei Buchstaben enthalten.
Beispiele:
|
| S | Millisekunden. Dieses Muster muss einen bis fünf Buchstaben enthalten. Der Wert wird entsprechend der Anzahl der verwendeten Buchstaben gerundet. Wenn fünf Zeichen verwendet werden (SSSSS), werden gebrochene Millisekunden angezeigt.
Beispiele:
|
| z | Zeitzone. Repräsentiert die Zeitzone als String, der Standard- oder Sommerzeit berücksichtigt, ohne sich auf einen bestimmten Standort zu beziehen. Dieses Muster wird nicht von allen Betriebssystemen unterstützt. Bei Betriebssystemen, die keine Zeitzonenmuster unterstützen, werden die Buchstaben des Eingabemusters durch einen leeren String ersetzt. Bei Betriebssystemen, die dieses Muster unterstützen, haben nicht alle Gebietsschemas einen definierten String. Für diese Gebietsschemas wird als Ausweichlösung ein lokalisiertes GMT-Format verwendet, zum Beispiel GMT-08:00 oder GW-08:00.
Dieses Zeitzonenmuster muss einen bis vier Buchstaben enthalten, die folgendermaßen interpretiert werden:
Beispiele für Betriebssysteme, die dieses Format unterstützen:
|
| Z | Zeitzone. Repräsentiert die Zeitzone als Abweichung von GMT. Dieses Muster wird nicht von allen Betriebssystemen unterstützt. Bei Betriebssystemen, die keine Zeitzonenmuster unterstützen, werden die Buchstaben des Eingabemusters durch einen leeren String ersetzt.
Dieses Zeitzonenmuster muss einen bis vier Buchstaben enthalten, die folgendermaßen interpretiert werden:
Beispiele für Betriebssysteme, die dieses Format unterstützen:
|
| v | Zeitzone. Ein String, der die allgemeine Zeitzone repräsentiert, die sich nicht auf einen bestimmten Standort bezieht oder zwischen Sommerzeit und Standardzeit unterscheidet. Dieses Muster wird nicht von allen Betriebssystemen unterstützt. Bei Betriebssystemen, die keine Zeitzonenmuster unterstützen, werden die Buchstaben des Eingabemusters durch einen leeren String ersetzt. Bei Betriebssystemen, die dieses Muster unterstützen, werden Ersatzstrings bereitgestellt, wenn kein lokalisierter Name verfügbar ist.
Dieses Zeitzonenmuster muss einen oder vier Buchstaben enthalten, die folgendermaßen interpretiert werden:
Beispiele für Betriebssysteme, die dieses Format unterstützen:
|
| 'Weiterer Text' | Der Musterstring kann Text und Satzzeichen enthalten. Die Zeichen von a bis z und A bis Z sind jedoch als Syntaxzeichen reserviert und müssen in halbe Anführungszeichen gesetzt werden, damit sie im formatierten String enthalten sind. Soll ein halbes Anführungszeichen im Ergebnisstring angezeigt werden, müssen im Musterstring zwei halbe Anführungszeichen verwendet werden. Die beiden halben Anführungszeichen können innerhalb oder außerhalb eines in Anführungszeichen gesetzten Teils des Musterstrings vorkommen. Ein unverbundenes Paar von halben Anführungszeichen wird am Ende des Strings terminiert.
Beispiele:
|
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Parameter
pattern:String |
Auslöser
TypeError — wenn der pattern-Parameter null ist.
|
Verwandte API-Elemente
setDateTimeStyles | () | Methode |
public function setDateTimeStyles(dateStyle:String, timeStyle:String):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2 |
Legt den Stil für Datums- und Uhrzeitangaben für diese DateTimeFormatter-Instanz fest. Mit Datums- und Uhrzeitstilen werden Muster für die Formatierung von Datum und Uhrzeit auf vordefinierte, vom Gebietsschema abhängige Muster vom Betriebssystem eingestellt. Diese Methode ersetzt die Stile, die mit dem DateTimeFormatter()-Konstruktor oder der setDateTimePattern()-Methode festgelegt wurden. Das Datums- und Uhrzeitmuster wird ebenfalls anhand der festgelegten Stile aktualisiert.
Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:
LastOperationStatus.NO_ERROR
Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.
Parameter
dateStyle:String — Gibt den Stil an, der beim Formatieren von Datumsangaben verwendet wird. Der Wert entspricht einem der Werte, die von der DateTimeStyle-Klasse aufgezählt werden:
| |
timeStyle:String — Gibt den Stil an, der beim Formatieren von Uhrzeitangaben verwendet werden wird. Der Wert entspricht einem der Werte, die von der DateTimeStyle-Klasse aufgezählt werden:
|
Auslöser
ArgumentError — wenn der dateStyle- oder timeStyle-Parameter keine gültige DateTimeStyle-Konstante ist.
| |
TypeError — wenn der dateStyle- oder timeStyle-Parameter null ist.
|
Verwandte API-Elemente
In diesem Beispiel werden die folgenden Gebietsschemas verwendet: Englisch (USA), Französisch (Frankreich), Spanisch (Spanien).
Das Beispiel führt für jedes Gebietsschema in der Liste Folgendes aus:
- Erstellt ein DateTimeFormatter-Objekt mit dem Standardstil (long dateStyle, long timeStyle).
- Formatiert das aktuelle Datum und die Uhrzeit unter Verwendung des standardmäßigen langen Datumsstils.
- Wechsel zu einem kurzem Datumsstil (nur Uhrzeit) mithilfe der Konstanten
DateTimeStyle.NONEundDateTimeStyle.SHORT. - Formatiert das aktuelle Datum und die Uhrzeit unter Verwendung des standardmäßigen kurzen Datumsstils (nur Uhrzeit).
package {
import flash.display.Sprite;
import flash.globalization.DateTimeFormatter;
import flash.globalization.DateTimeStyle;
public class DateTimeFormatterExample extends Sprite
{
private var localeList:Array = new Array("en-US", "fr-FR", "es-ES");
public function DateTimeFormatterExample()
{
var date:Date = new Date();
for each (var locale:String in localeList) {
var dtf:DateTimeFormatter = new DateTimeFormatter(locale);
trace('\n' + "LocaleID requested=" + dtf.requestedLocaleIDName
+ "; actual=" + dtf.actualLocaleIDName);
var longDate:String = dtf.format(date);
trace(longDate + " (" + dtf.getDateTimePattern() + ")");
dtf.setDateTimeStyles(DateTimeStyle.NONE, DateTimeStyle.SHORT);
var shortDate:String = dtf.format(date);
trace(shortDate + " (" + dtf.getDateTimePattern() + ")");
}
}
}
}
Das Beispiel führt für jedes Gebietsschema in der Liste Folgendes aus:
- Erstellt drei Eingabe- und Ausgabetextfelder.
- Erstellt ein DateTimeFormatter-Objekt unter Verwendung des Gebietsschemas für amerikanisches Englisch.
- Ruft die
configureTextField()-Funktion auf, die die Position und die Größe der Textfelder festlegt, und fügt einen Ereignis-Listener für daspatternField-Objekt hinzu. - Wenn der Benutzer das Muster in das Textfeld
patternFieldeingibt, formatiert dietextInputHandler-Funktion das aktuelle Datum und die Uhrzeit anhand dieses Musters und zeigt das Ergebnis und den Wert vonlastOperationStatusin den Ausgabetextfeldern an.
package {
import flash.display.Sprite;
import flash.events.Event;
import flash.globalization.DateTimeFormatter;
import flash.text.*;
public class DateTimePatternExample extends Sprite
{
private var patternField:TextField = new TextField();
private var resultField:TextField = new TextField();
private var statusField:TextField = new TextField();
private var date:Date = new Date();
private var dtf:DateTimeFormatter = new DateTimeFormatter("en-US");
private function configureTextField():void
{
patternField.type = TextFieldType.INPUT;
patternField.width = 300;
patternField.height = 20;
patternField.background = true;
patternField.border = true;
resultField.y = 40;
resultField.width = 300;
resultField.height = 20;
statusField.y = 80;
statusField.width = 300;
statusField.height = 20;
addChild(patternField);
addChild(resultField);
addChild(statusField);
patternField.addEventListener(Event.CHANGE,textInputHandler);
}
private function textInputHandler(event:Event):void
{
dtf.setDateTimePattern(patternField.text);
statusField.text = dtf.lastOperationStatus;
resultField.text = dtf.format(date);
}
public function DateTimePatternExample()
{
configureTextField();
}
}
}
Tue Jun 12 2018, 10:04 AM Z